home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1993 / MacHack 1993.toast / MacHack™ 1987-1992 / MacHack™ '90 / Source Code ƒ / Misc. Pascal ƒ / Jay's Cookie / ReadMe < prev   
Encoding:
Text File  |  1990-06-15  |  3.7 KB  |  105 lines  |  [TEXT/MPS ]
  1.                                 D. Jay Newman
  2.                                 dn5@psuvm.psu.edu
  3.  
  4.  
  5. Hi:
  6.  
  7. This is about my Cookie DA.  It is basically the best Fortune Cookie
  8. of any type available for the Mac (I say this even though I wrote it,
  9. because I am a modest sort of guy).  It is fast, and runs on all Mac's
  10. I've tested it on.  It also includes a 600k Fortune file.
  11.  
  12. Features:
  13.  
  14. Its a DA, so can be called from an App if you feel in the need of wasting
  15. a few seconds.
  16.  
  17. A large fortune file, gathered from the net (and other places).  I would
  18. like to thank Henry Cate III, because I got some of my short quotes from
  19. his postings, and I would also like to thank many other people, too numerous
  20. to name.
  21.  
  22. The window is resizable, and the fortunes will re-wrap to conform to the
  23. size of the window.  Most of them look good this way.  Some of them
  24. (mainly signitures taken from the net) are designed for a fixed size
  25. window, and look bad if the window is made smaller -- I put hard returns
  26. in these signitures because that was how they were originally).
  27.  
  28. The DA remembers where your window was, and how big it was between invocations.
  29. Disclaimer: it works fine at home between restarts, but falls to its default
  30. size and position after a restart on the Mac IIcx's here.  I WILL fix this,
  31. but couldn't find MPW Pascal here to do this!  It also looks ugly the first
  32. time it is called from System 7; I will fix this also.
  33.  
  34. Installation:
  35.  
  36. Install the DA, and put the Fortunes file in the System Folder.  Bad things
  37. may happen if it can't find its Fortunes file.  The name is hard-coded :-(.
  38.  
  39. Things for you to do:
  40.  
  41. If you have MPW, you can add new fortunes, and correct my spelling mistakes!
  42. Merely edit the file Fortunes.Raw, and then rebake the cookies.  The MPW tool
  43. (Bake), complete with source code, is provided for your pleasure.  The
  44. correct command line is:
  45.  
  46.      Bake Fortunes.Raw Fortunes
  47.  
  48. Then move the new fortunes file into the system folder.  There is a bug in
  49. the Bake tool that improperly creates the new file if an old Fortunes file
  50. exists, so I always delete the old one before baking a new one.  I may have
  51. fixed the bug, but I don't remember.
  52.  
  53.  
  54. Format of Fortunes.Raw
  55.  
  56. The Bake tool removes hard returns inside cookies if the start of the next
  57. line starts with an alpha character (possiblly alpha-numeric).  There are
  58. a few special characters accepted to change this behavior.  These must be
  59. on lines of their own, with NO extra characters!
  60.  
  61. %%        End of cookie
  62. $$        Leave a single blank line here (put 2 hard returns here)
  63. !!        Put a hard return here
  64.  
  65.  
  66. HyperCard:
  67.  
  68. I have also included a HyperCard XCMD and stack which can understand the
  69. format of my cookie file, and will read a file.  It took about 20 minutes
  70. on a Mac II when my file was about 2/3 the present size to create this
  71. stack.  It is the only way of looking at ALL the cookies without MPW.
  72.  
  73. Unfortunately I stopped there.  I haven't written an XCMD to create a new
  74. fortune file from a HyperCard stack.  It shouldn't be too hard, I just
  75. haven't had time to do such a thing.
  76.  
  77.  
  78. Format of a Fortunes file:
  79.  
  80. <longint>            Number of Cookies
  81. <longints>            A number of longints equal to the number of cookies + 1
  82.                     These are offsets from the start of the cookie data of
  83.                     the start of each cookie.  The extra one is there to
  84.                     be able to calculate the length of the last cookie.
  85. <text>                Just plain text, with no delimiters
  86.  
  87.  
  88.  
  89. How to contact me:
  90.  
  91. I am D. Jay Newman, and I can be reached on the net by
  92.     dn5 @ psuvm.psu.edu
  93.  
  94. I can also be reached by snail mail at
  95.     D. Jay Newman
  96.     CBEL
  97.     12 Willard Building
  98.     University Park, PA  16802
  99.  
  100. Thanks for reading this, and if you have any fixes, please let me know.
  101.  
  102. I release this document, and all the source code for my Cookie DA, the Bake
  103. Tool, and the CookieEdit HyperCard XCMD to the public domain.
  104.  
  105.                     D. Jay Newman